JxBrowser/com.teamdev.jxbrowser.browser/[jvm]Browser

Browser

interface Browser : Closeable, Advisable<P> , Observable<T>

A web browser control that allows loading a web page or a local HTML file, accessing DOM and executing JavaScript on the loaded web page, getting notifications about loading progress, dispatching keyboard and mouse events, etc.

The Browser instance itself is running in a separate native process that allocates memory and system resources that must be released. So, when a Browser instance is no longer needed, it must be closed through the close method to release all the allocated memory and system resources. For example:

Browser browser = engine.newBrowser();
...
browser.close();

Any attempt to use an already closed Browser instance will lead to the IllegalStateException.

The Browser instance is closed automatically when its Engine is closed or unexpectedly crashed. If the instance represents a popup window created by JavaScript via the window.open() function, then JavaScript can close the instance using the window.close() function.

To get notifications that the Browser instance has been closed please subscribe to the following event:


browser.on(BrowserClosed.class, event -> {
    // The Browser instance has been closed.
});

Properties

audio

val Browser.audio: Audio

Returns the service that allows controlling audio on a currently loaded web page.

bitmap

val Browser.bitmap: Bitmap

Returns a Bitmap that contains the image of the currently loaded web page.

defaultPresentationRequest

val Browser.defaultPresentationRequest: PresentationRequest?

Returns the default JavaScript PresentationRequest specified on the page.

devTools

val Browser.devTools: DevTools

Returns the service that allows working with Chromium Developer Tools.

display

val Browser.display: Display

Returns the display where the current browser instance is located.

engine

val Browser.engine: Engine

Returns the engine instance of this Browser.

favicon

val Browser.favicon: Bitmap

Returns a Bitmap that contains the favicon of the currently loaded web page or the default Chromium favicon if the browser did not load any web pages or loaded web page URL is invalid.

focusedFrame

val Browser.focusedFrame: Frame?

Returns the focused frame on the currently loaded web page, if any.

frames

val Browser.frames: List<Frame>

Returns all the frames on the currently loaded web page or an empty collection if the browser did not load any web pages.

fullScreen

val Browser.fullScreen: FullScreen

Returns the service that controls the fullscreen mode.

mainFrame

val Browser.mainFrame: Frame?

Returns the main frame of the currently loaded web page, if any.

navigation

val Browser.navigation: Navigation

Returns Navigation of this Browser.

profile

val Browser.profile: Profile

Returns the profile that the browser belongs to.

renderingMode

val Browser.renderingMode: RenderingMode

Returns a rendering mode of this Browser.

settings

val Browser.settings: BrowserSettings

Returns settings that configure this Browser.

size

val Browser.size: Size

Returns the size of this Browser in the logical pixels.

textFinder

val Browser.textFinder: TextFinder

Returns the service that allows searching text on a currently loaded web page.

title

val Browser.title: String

Returns a string that represents the title of the currently loaded web page, or an empty string if the browser hasn't loaded any web page yet.

url

val Browser.url: String

Returns a string that represents URL of the currently loaded web page, or an empty string if the browser hasn't loaded any web page yet.

userAgent

val Browser.userAgent: String

Returns a string that represents the user-agent of this Browser.

zoom

val Browser.zoom: Zoom

Returns the service that allows zooming content of a currently loaded web page.

Functions

audio

abstract fun audio(): Audio

Returns Audio that allows controlling audio on a web page loaded in the current browser instance.

bitmap

abstract fun bitmap(): Bitmap

Returns a Bitmap that contains the image of the currently loaded web page.

callback

inline fun <C : Callback> Advisable<in C>.callback(): C?

Returns the currently registered callback of type C, if any.

captureSessions

abstract fun captureSessions(): List<CaptureSession>

Returns an immutable list of all active capture sessions initiated by the browser.

cast

abstract fun cast(receiver: MediaReceiver): CompletableFuture<CastSession>

Starts casting the browser content to the media receiver.

castScreen

abstract fun castScreen(receiver: MediaReceiver): CompletableFuture<CastSession>

Starts casting screen's content by selecting the screen in the picker dialog.

abstract fun castScreen(receiver: MediaReceiver, options: ScreenCastOptions): CompletableFuture<CastSession>

Starts casting the screen's content to the media receiver.

abstract fun close()

Closes the current browser instance and releases all allocated resources.

abstract fun close(options: CloseOptions)

Closes the current browser instance according to the given options.

abstract fun close()

fun Browser.close(fireBeforeUnload: Boolean = false)

Closes the browser instance.

defaultPresentationRequest

abstract fun defaultPresentationRequest(): Optional<PresentationRequest>

Returns the default JavaScript PresentationRequest specified on the page.

devTools

abstract fun devTools(): DevTools

Returns DevTools that allows working with Chromium Developer Tools.

dispatch

abstract fun dispatch(event: KeyPressed)

Dispatches the key pressed event to the currently focused element on the loaded web page.

abstract fun dispatch(event: KeyReleased)

Dispatches the key released event to the currently focused element on the loaded web page.

abstract fun dispatch(event: KeyTyped)

Dispatches the key typed event to the currently focused element on the loaded web page.

abstract fun dispatch(event: MouseDragged)

Dispatches the mouse dragged event to the currently loaded web page.

abstract fun dispatch(event: MouseEntered)

Dispatches the mouse entered event to the currently loaded web page.

abstract fun dispatch(event: MouseExited)

Dispatches the mouse exited event to the currently loaded web page.

abstract fun dispatch(event: MouseMoved)

Dispatches the mouse moved event to the currently loaded web page.

abstract fun dispatch(event: MousePressed)

Dispatches the mouse pressed event to the currently loaded web page.

abstract fun dispatch(event: MouseReleased)

Dispatches the mouse released event to the currently loaded web page.

abstract fun dispatch(event: MouseWheel)

Dispatches the mouse wheel event to the currently loaded web page.

abstract fun dispatch(event: TouchCanceled)

Dispatches the touch canceled event to the currently loaded web page.

abstract fun dispatch(event: TouchEnded)

Dispatches the touch ended event to the currently loaded web page.

abstract fun dispatch(event: TouchMoved)

Dispatches the touch moved event to the currently loaded web page.

abstract fun dispatch(event: TouchStarted)

Dispatches the touch started event to the currently loaded web page.

display

abstract fun display(): Display

Returns the display where the current browser instance is located.

engine

abstract fun engine(): Engine

Returns the engine instance of the current browser.

favicon

abstract fun favicon(): Bitmap

Returns a Bitmap that contains the favicon of the currently loaded web page or a Bitmap that contains default Chromium favicon if the browser did not load any web pages or loaded web page URL is invalid.

focus

abstract fun focus()

Tells the current browser instance that it has focus and must be activated.

focusedFrame

abstract fun focusedFrame(): Optional<Frame>

Returns an Optional that contains the focused Frame on the currently loaded web page, otherwise an empty Optional.

frames

abstract fun frames(): List<Frame>

Returns all the frames on the currently loaded web page or an empty collection if the current browser did not load any web pages.

fullScreen

abstract fun fullScreen(): FullScreen

Returns the service that controls the fullscreen mode.

get

abstract fun <C : P?> get(callbackClass: Class<C>): Optional<C>

Returns an Optional that contains the callback of the given type or an empty


Optional

if there is no registered callback with the given type.

isClosed

abstract fun isClosed(): Boolean

Returns true if the current object is closed.

mainFrame

abstract fun mainFrame(): Optional<Frame>

Returns an Optional that contains the main Frame of the currently loaded web page if it exists, otherwise an empty Optional.

navigation

abstract fun navigation(): Navigation

Returns Navigation that allows controlling navigation in the current browser instance.

abstract fun <E : T?> on(eventClass: Class<E>, observer: Observer<E>): Subscription

Subscribes the given event observer to receive the events of the given


eventClass

profile

abstract fun profile(): Profile

Returns the profile that the browser belongs to.

inline fun <C : Callback> Advisable<in C>.register(callback: C): C?

Registers the given callback in this Advisable.

remove

abstract fun <C : P?> remove(callbackClass: Class<C>): C

Removes a particular service callback.

removeCallback

inline fun <C : Callback> Advisable<in C>.removeCallback(): C?

Removes a callback of type C from this Advisable, if any.

replaceMisspelledWord

abstract fun replaceMisspelledWord(word: String)

Replaces misspelled word under cursor on the currently loaded web page with the given


word

resize

abstract fun resize(size: Size)

Updates size of the current browser instance with the given one.

abstract fun resize(width: Int, height: Int)

Updates size of this Browser instance with the given width and height.

saveWebPage

abstract fun saveWebPage(htmlFilePath: Path, resourcesDir: Path, saveType: SavePageType): Boolean

Initiates the saving process of the currently loaded web page.

set

abstract fun <C : P?> set(callbackClass: Class<C>, callback: C): C

Sets a particular service callback.

settings

abstract fun settings(): BrowserSettings

Returns BrowserSettings that allows configuring the current browser instance.

size

abstract fun size(): Size

Returns the size of the current browser instance in the logical pixels.

inline fun <E : Event> Observable<in E>.subscribe(observer: Observer<E>): Subscription

Subscribes the given observer to receive events of type E from this Observable.

textFinder

abstract fun textFinder(): TextFinder

Returns TextFinder that allows finding text on a web page loaded in the current browser instance.

title

abstract fun title(): String

Returns a string that represents the title of the currently loaded web page or an empty string if the browser hasn't loaded any web page yet.

unfocus

abstract fun unfocus()

Tells the current browser instance that it does not have focus and must be deactivated.

url

abstract fun url(): String

Returns a string that represents URL of the currently loaded web page or an empty string if the browser hasn't loaded any web page yet.

userAgent

abstract fun userAgent(): String

Returns a string that represents the user-agent of the current browser instance.

abstract fun userAgent(userAgent: String)

Updates the user-agent string of the current browser instance and reloads the currently loaded web page.

zoom

abstract fun zoom(): Zoom

Returns Zoom that allows zooming content of a web page loaded in the current browser instance.